UnRelateRecordFromAll

Object and Type

Object  : FCGeneric

Type     : Method

Prototype

Public Sub UnRelateRecordFromAll(ByVal the_rel As String)                             

Description

This method will unrelate the current record in a generic object from all other objects that it is related to via the specified relation. For example, if a case is related to 100 research logs, and you would like to unrelate it from all of them (in one method call), simply call this method with the proper case relation.

The method works for any and all cardinalities (OTM, MTO, OTO, MTM), and the related objects do NOT need to be in a generic object.

Note: The unrelate does not take place until the Update or UpdateAll method is called to update the current record in the generic object.

Parameters         

Parameter Name                Required?             Description                                                                                          

the_rel                                    Yes                         The relation to use to find the objects to unrelate

Error Codes

Value                                     Meaning                                                                                                                               

12031                                      This operation is not valid for a generic that is marked distinct

Example

The following example unrelates the specified case from all part_used records.

JavaScript:

The code in this example is written in JavaScript for inclusion in ASP pages.

  // Query cases

  var boCase = FCSession.CreateGeneric();

  boCase.SimpleQuery("case");

  boCase.Query();

  // Now unrelate it from all part used records

  boCase.UnRelateRecordFromAll("case2part_used");

  boCase.Update();

Visual Basic:

The code in this example is written in Visual Basic.

  Dim boCase As FCGeneric

  Set boCase = fc_session.CreateGeneric

  boCase.SimpleQuery "case"

  boCase.Query

  boCase.UnRelateRecordFromAll "case2part_used"

  boCase.Update